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TITLE 

Computer Framework and Method for Isolating a Business Component from Specific 
Implementations of a Datastore 

5 BACKGROUND OF THE INVENTION 

The present invention relates to a computer framework and method for a business 
component to retrieve data from a variety of backend datastores using object technology. 
The invention provides for the creation, retrieval, updating, and deletion of objects in one 
or more datastores without having to know the vendor specific application programming 
10 interfaces (APIs) of the datastores. 

In designing a composite, enterprise-wide computing system for a business, it is desirable 
to divide the system architecture into layers or levels that are independent of ones below 
it. This is known as multilevel modularity, wherein the functionality of each level is 
15 independent of its uses in higher levels and the structure of lower levels. Multilevel 
modularity is advantageous as it allows for changes to a given level without disturbing 
other levels. 



The business components of a computing system contain the business rules or 
20 functionality of a given application, and thus constitute a relatively high level system. In 
executing an application, business components often have to interact with a lower level 
datastore to create, retrieve, update, and delete data following processing by the 
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application. Business components ideally are wholly reusable and independent of any 
underlying data source. 

Business components can be programmed to interact directly with a datastore, but this is 
5 a burdensome and inflexible process. For example, database vendors each have a unique 
set of application programming interfaces (APIs) which allow applications to create, 
retrieve, update, and delete data from the database. Not only do these API's vary by 
vendor, but they also vary by the type of datastore. The API's for a relational database 
typically are much different from the API's for an object database, and so on. Thus, the 
10 problem is that a business component must contain specific code for each individual 
datastore accessed by the component. If a datastore is added, deleted, or modified, the 
business application code must be modified as well. 



yl The current invention addresses the need for an enterprise-level framework and method 

fin 15 to isolate higher level systems implementing business applications (herein referred to as 
O business components) from middle level systems (herein referred to as domain objects) 

accessing persistent data stored in a variety of differing lower-level datastores. The 
invention provides a single interface for the business component to perform datastore 
manipulations that might otherwise require multiple separate interfaces. The current 
20 invention further addresses the domain objects' need for datastore neutrality and 
abstraction; their need to be pure in implementation; and their need to be independent of 
any architectural level including any underlying persistent datastore level. 
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SUMMARY OF THE INVENTION 

The present invention relates to a computer framework and method for a business 
component to retrieve data from a backend datastore. The invention discloses a method 
for isolating a business component from specific implementations of a datastore, 
5 comprising supplying a database wrapper; using the database wrapper to begin a database 
session; supplying a domain object factory; using the domain object factory to create a 
domain object; converting the domain object from a persistent state to a transient state; 
ending the database session; and returning the domain object to the business component. 

Q 

J3 10 The invention further discloses a method for isolating a business component from 

1 ri 

specific implementations of a datastore, comprising interfacing a database wrapper to a 
business component; implementing the database wrapper; interfacing a domain object 
factory to the database wrapper; implementing the domain object factory; interfacing a 
domain object to the domain object factory; and implementing the domain object to 
15 retrieve data from a datastore. The method may further comprise the step of converting 
data retrieved from the datastore from a persistent state to a transient state. 
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The invention further discloses a framework for isolating a business component from 
specific implementations of a datastore, comprising a database wrapper in 
20 communication with a business component; a domain object factory in communication 
with the database wrapper; a domain object in communication with the domain object 
factory; and a datastore in communication with the domain object. The database wrapper 
further comprises a database wrapper interface in communication with the business 
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component and a database wrapper implementation implementing the domain object 
factory. The domain object factory further comprises a domain object interface in 
communication with the database wrapper and a domain object factory implementation 
implementing the domain object. The domain object further comprises a domain object 
interface in communication with the domain object factory and a domain object 
implementation retrieving data from a datastore. The domain object interface further 
comprises a transient data converter for converting the domain object from a persistent 
state to a transient state. 

DESCRIPTION OF THE DRAWINGS 

Figure 1 is a graphical representation of the invention. 

Figure 2 is a domain object class diagram. 
Figure 3 is a domain object factory class diagram. 
Figure 4 is a database wrapper class diagram. 

^ Figur e 5 io a graphical r e pr e sentation of one embodiment of tho invention. 




DETAILED DESCRIPTION OF THE INVENTION 

As shown in Fig. 1, the current invention provides a business component 5 with a 
common interface 10 to a plurality of domain objects 15, 20, and 25 stored in a variety of 
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datastores, thereby decoupling the storage of data from a specific type of datastore. The 
invention provides a framework and method for accessing data from different types of 
datastores while maintaining a common interface to the existing business 
functions/applications being carried out by the business component. The advantage of the 
5 current invention is that it provides a single interface to perform datastore manipulation 
that would otherwise require two or more separate interfaces. In other words, the 
invention encapsulates the capabilities of multiple datastores into a single interface. 



Datastore as used herein means any type of data storage software device or medium, 
10 including datafiles, databases, memory chips, hard drives, floppy drives, magnetic 

si 

storage media, optical storage media, and the like. Preferably, the datastore is a database, 

y £ 

fy which can be either a relational or object database. Examples of suitable databases are 

Ly 

s relational databases produced by Oracle, Inc. and object databases produced by Versant 

O 

yi Inc. The datastore can be located remotely and accessed by means such as the Object 

sU 

rL: 15 Management Group's Common Object Request Broker Architecture (CORBA), which 
™ communicates with underlying datastores such as relational databases. When the 

underlying datastore comprises a relational database, object-relational (O-R) mapping 
tools, such as TOPLink produced by The Object People, Inc., may be used in carrying out 
the invention. As known to those skilled in the art, O-R mapping tools serve as a 
20 communications bridge between object technology and relational database technology. 
Likewise, the Java/Versant interface (JVI) available from Versant Inc. can be used in 
carrying out this invention to serve as a communications bridge between the Java 
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programming language (which is available from Sun Microsystems Inc.) and object 
databases produced by Versant Inc. 



The first step in developing a domain object is to create its interface. An interface (also 
known as a message interface) is a communication surface that determines the signals 
(e.g., calls) that can pass through the surface; in other words, the interface defines which 
calls an object will respond to. An interface can contain other object interfaces, allowing 
interfaces to be mixed and matched across objects. A domain object's interface should 
define those having access to the object (e.g., its public accessors) as well as any 
functionality (e.g., behavior) for the domain object. Return types and parameter types in 
domain object interfaces will consist of basic types (string, integer, boolean, etc.) and 
other domain object interface types (address, contact, etc.). An interface for a domain 
object referred to hereinafter as Customer is created by the following programming code: 

public interface Customer { 
//Accessors for name 
public String getName(); 
public void setName(String name); 

//Accessors for address 

public Address getAddress(); 

public void setAddress(Address address); 

public boolean isValid(); 
J 

While the code examples herein are written in the Java programming language, which is 
available from Sun Microsystems Inc., it is understood that other suitable programming 
languages may be used as will be readily apparent to one skilled in the art. Furthermore, 
it should be understood that the code examples are in skeleton or outline form, and are 
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not necessarily intended to be in complete executable form, provided however that one 
skilled in the art could easily tailor executable code based upon these examples. 



Interfaces keep business components and other programming code neutral to the 
implementation of domain objects. For example, the interface for Customer is visible to 
a business component. A developer can create multiple implementations of Customer 
that implement the Customer interface, which a program developer might do if Customer 
can reside in either an object database or in a relational database. Because the 
implementations conform to the Customer interface, each implementation can be used 
^ 10 wherever Customer is needed. This makes the business components highly reusable; if 
the underlying database of a domain object changes, the business component can simply 
"plug in" the appropriate implementation for its domain objects. In sum, the domain 
object interface is wholly reusable and database neutral. 



n 15 Because it is desireable to keep business components as reusable as possible, developers 
preferably do not directly create domain objects through code such as: 



p 



public class BusinessComponent { 

public Customer createCustomer(String name, Address address) { 
Customer customer = new CustomerImpl(name, address); 
return customer; 

} 

} 



The preferred method for creating domain objects is through a domain object factory, as 
20 discussed below. 
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The second step in creating a domain object is to implement it, and a separate 
implementation must be performed for each database in which the domain object is 
stored. The implementation of a domain object consists of a class definition that 

5 implements the domain object interface. As used in object technology, a class defines the 
methods and variables for a particular type of object; all objects of a given class are 
identical in form and behavior but contain different data in their variables. Accessors are 
the methods on a class that provide access to the variables of the class (for example, get 
and set commands). The class name must be different from the interface name, and for 

10 ease of reference the letters "Impl" (an abreviation of implementation) are added to the 
end of the interface name. Implementation of the interface for the Customer domain 
object is as follows: 



public class Customerlmpl implements Customer { 
private String name; 
private Address address; 

public String getName() { 
return name; 

} 

public void setName(String name) { 
this.name = name; 

} 

public Address getAddress() { 
return address; 

} 

public void setAddress(Address address) { 
this.address = address; 

i 



As shown in Fig. 2, a domain object is implemented for each database in which its state 
15 resides. State as used herein refers to the persistent data residing in an underlying 
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datastore which defines the variables for a given instance of a domain object. If 
Customer state can reside in an object database as well as a relational database, a 
developer creates a Customer implementation for the object database and a separate 
implementation for the relational database. 

The storage and retrieval of data by a domain object from a persistent datastore is 
accomplished by implementation of methods contained within the domain object and is 
represented by boxes 15, 20, and 25 in Figure 1. An instance of the domain object is 
created upon implementation, which is also referred to as an instantiation of the domain 
object. More specifically, Domain Object A is a domain object instantiation created by 
retrieving data from Persistent Datastore A by implementing the data retrieval methods 
contained within the domain object, and so on. 

Often, domain object classes are named to reflect the database in which they reside. As 
shown in Fig. 2, the Customer domain object 30 can be implemented from relational 
database 35 by using the TOPLink object-relational mapping tool; from object database 
40, for example by using a Java/Versant interface (JVI); or from any number of other 
datastores known to those skilled in the art. As shown in Fig. 2, regardless of the 
underlying datastore (and supplemental communications bridge such as TOPLink, JVI, or 
otherwise), the interface for the Customer domain object remains the same to the business 
component accessing it. 
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Implementation of the Customer domain object residing in a relational database accessed 
via the TOPLink O-R mapping tool is defined as follows: 



Public class CustomerTOPLinklmpl implements Customer { 
protected String name; 
protected ValueHolderlnterface address; 

public String getName() { 
return name; 

} 

public void setName(String name) { 
this.name = name; 

} 

public Address getAddress() { 
//implemented later 

} 

public void setAddress(Address new Address) { 
//implemented later 

} 

private ValueHolderlnterface getAddressHolder() { 

return address; 

} 

private void setAddressHolder(ValueHolderInterface holder) { 

address = holder; 

} 

public void isValidO { 

//some validation code 



} 



} 



In this class definition, CustomerTOPLinklmpl is the name of the class. "Customer" has 
been appended with "TOPLinklmpl" to show that it is a TOPLink implementation for the 
Customer domain object. The class CustomerTOPLinklmpl implements the Customer 
interface and can be used wherever Customer is specified in code. 
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Preferably, a business component has visibility to the domain object interface type rather 
than the class type. The following code is not desirable since the business component 
interacts directly with the class: 



public class BusinessComponent { 

public Customer createCustomer(args) { 

Customer customer = new CustomerTOPlinkImpl(); 
return customer; 

} 

1 



The problem with the above code is that by calling new on the class 
CustomerTOPLinklmpl, the BusinessComponent class must be re-implemented if the 
S database for Customer domain objects changes. The BusinessComponent would have the 
same code as above but call the constructor for another Customer implementation. 
Preferably, business components never use new directly. The preferred method for 
10 creating domain objects is use of a domain object factory, as discussed below. 

Since the implementation of a domain object is specific to a datastore, the domain 
object's variables (also known as fields or attributes) can be defined using the datastore' s 
particular data types. Accessors are the commands (e.g., APIs) used to access persistent 
15 datasets from datastores, said datasets providing the values (or "state") for the domain 
object's variables/fields. All domain object interfaces preferably have accessors that 
operate in terms of standard Java standard datatypes (e.g., Boolean, String, Integer, etc.) 
or other domain object interface types (e.g., Customer, Address, etc.), thereby 
maintaining the datastore neutrality of a business component utilizing the domain object 
20 accessor. Although domain object accessors operate in terms of Java standard datatypes, 
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the internal domain object implementations can be in terms of datastore specific types. In 
the case of a Versant object database, the type Handle can be used for references to other 
domain objects. In the case of a relational database accessed via the TOPLink OR 
mapping tool, the ValueHolder type can be used to reference other domain objects. The 
use of these standard API types helps exploit efficiencies in the database implementation 
but adds constraints to field access. The following code illustrates the use of accessors on 
a Customer domain object residing in a relational database accessed via the TOPLink OR 
mapping tool. The interface is as follows: 



public interface Customer { 

public Address getAddress(); 

public void setAddress(Address address); 

J 



And the class is as follows: 



public class CustomerTOPLinklmpl implements Customer { 

protected String name; 

protected ValueHolderlnterface address; 

public String getName() { 
return name; 

} 

public void setName(String name) { 
this.name = name; 

} 

public Address getAddress() { 

return (Address) address.getValue(); 

} 

public void setAddress(Address new Address) { 
address.setValue(new Address); 

} 

private ValueHolderlnterface getAddressHolder() { 
return address; 

private void setAddressHolder(ValueHolderInterface holder) { 
address = holder; 

public void isValidQ { 
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//some validation code 

} 

J 

In this code, Address is an interface type. There are two pairs of accessors for the 
address field. The first pair is defined on the Customer interface and provides a view of 
the Customer's internal state consistent with a pure domain model; in other words, the 
first pair is called by and maintains a generic interface to the business component. The 
first pair of accessors uses TOPLink commands to convert the ValueHolder into an 
Address and back to a ValueHolder. The second pair is a private view for internal and 
infrastructure use; in other words, the second pair is called the domain object and invokes 
TOPLink commands to retreive data from a relational database. The second pair of 
accessors sets and gets a TOPLink ValueHolder. 

Domain objects are considered persistent while in context of a database session and are 
not valid outside the database session. Therefore, the domain objects should be made 
transient (i.e., not tied to the database session) before being passed to a business 
component. A transient domain object is a database neutral implementation of the 
domain object interface. For a Customer domain object, the developer creates a 
Customer interface, a CustomerTOPLinklmpl class (for TOPLink implementation), and a 
CustomerTransientlmpl class. The CustomerTransientlmpl class contains no database 
specific types or code. The CustomerTOPLinklmpl class includes a conversion method 
to convert the domain object from a persistent to a transient state (e.g. 
CustomerTransientlmpl). Such conversion methods are commonly known to those 
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skilled in the art. In the following code, the conversion method is referred to as 
copyTransientQ and is defined on the Customer domain object interface: 



public interface Customer { 

Customer copyTransientQ; 
} 



The implementation of the Customer interface would then implement the conversion 
method copyTransientQ. 



//Database implementation 

public class CustomerTOPLinklmpl implements Customer { 
protected String name; 
protected ValueHolderlnterface address; 
Customer copyTransient() { 

Return new CustomerTransientImpl(name, 
GetAddress().copyTransient()); 

} 



} 

//Transient implementation 

public class CustomerTransientlmpl implements Customer { 
protected String name; 
protected Address address; 
Customer copyTransient() { 
return this; 

} 

1 



In the database implementation above, copyTransient() constructs a transient Customer 
domain object with its fields. CopyTransient() must be called on all fields that reference 
other domain objects. In the example above, the field address references an Address 
domain object. Therefore, copyTransientQ is sent to the address field. 
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As discussed above in accordance with this invention, business components do not 
directly create domain objects, but rather use domain object factories. Domain object 
factories contain methods that allow for creation and querying of domain objects, thereby 
5 creating domain objects and retrieving them from the datastore. The creation of the 
object factories, and in particular domain object factories, of a type used in this invention 
will be familiar to one of skill in the art and need not be explained in detail here. 

The domain object factory framework parallels the domain object framework. As shown 
in Fig. 3, domain object factories consist of an interface 45 that specifies create and find 
methods available on the domain object factory and separate implementations 50 and 55 
specific to each datastore. Interface 45 for the domain object factory allows the business 
component to interact with a single interface while having the ability to "plug in" various 
datastore specific implementations, thereby maintaining the boundary between 
implementation specifics and the business component. The developer implements a 
datastore-specific domain object factory 60 or 65 for each datastore containing the 
requested domain object (e.g., Customer). Customer factory 70 returns interface types 
for Customer domain objects. 

20 The domain object factory code framework parallels the domain object code framework: 

public interface CustomerFactory { 
public Customer create(); 
public Customer findByName(String name); 
public Vector findAll(); 

} 

public class CustomerFactoryTOPLinklmpl 
extends DomainObjectFactoryTOPLinklmpl 

15 
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implements CustomerFactory { 
public Customer create() { 
return new CustomerTOPLinkImpl(); 

} 

public Customer findByName(String name) { 

//code to query TOPLink for a Customer by name 
return customer; 

} 

public Vector findAll() { 

//code to query TOPLink for all customers 
return customers; 

} 

] 



The domain object factory is a convenient location for datastore queries. Any query that 
needs to be performed for a given domain object type is placed in a "find" method on the 
domain object factory implementation. The find method can make full use of datastore 
specific code to generate queries, and thus a reason for separating the domain object 
factory interface from the implementation. 

Since a domain object factory implementation is specific to a given datastore, there must 
be a factory, herein referred to as a database wrapper, for the domain object factories. 
This is also parallel to the domain object framework. Preferrably, a business component 
does not directly instantiate a domain object factory. 

The database wrapper provides an API for session and transaction management which 
allows access to datastore (typically a database) functionality. The database wrapper is 
also the factory for creating domain object factories. As shown in Fig. 4, the database 
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wrapper interface 75 is used in the business component while the actual implementation 
type (e.g., DatabaseWrapperTOPLinklmpl 80 or DatabaseWrapperJVIImpl 85) is used 
in the domain object factory methods. Database wrapper implementations are retrieved 
by passing a properties object and a data source name to a method on the base class from 
5 a datastore (e.g., DatabaseWrapperBase 90) which will return the specific database 
wrapper implementation (e.g., DatabaseWrapperTOPLinklmpl 80). The creation of the 
database wrappers of a type used in this invention will be familiar to one of skill in the 
art. 

a domain object factory from the database wrapper, the developer simply calls 
n the database wrapper specifying the class name of the domain object factory 
The method returns type Object, so a developer must cast the return value to 
factory type as follows: 
1 

. . .//get database wrapper using getDatabaseWrapper; 
DatabaseWrapper db Wrapper = 

DatabaseWrapperBase.getDatabaseWrapper(properties, 
"CustomerDB"); 
CustomerFactory customerFactory = (CustomerFactory) 

dbWrapper.getDomainObjectFactory(CustomerFactory.class); 

J 

15 Once obtained, the domain object factory can be used to create and find domain objects 
as discussed previously. 

Example 

20 
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To achieve a common interface for each domain object, a business component operating 
in accordance with the invention typically follows the following steps: obtain a database 
wrapper from a datastore (e.g., a database); begin a database session; obtain a domain 
object factory from a datastore; create, find, and use domain objects from a datastore; 
convert the domain object from a persistent to a transient state; end the database session; 
and return requested information to the business component/application. The information 
returned to the business component can be in the form of transient domain objects. The 
following pseudo-code outlines a typical business component code for a domain object 
referred to as Customer: 



public Customer getCustomer(String id) { 
// get the database wrapper from the DatabaseWrapperBase 
// appCtx is a member variable of the business component 
Database Wrapper db Wrapper = 

Database WrapperBase.getDatabaseWrapper(properties, 
"CustomerDB"); 

// begin a database session 
dbWrapper.beginSession(); 

// get the domain object factory for customer 
CustomerFactory cf = (CustomerFactory) 

dbWrapper.getDomainObjectFactory(CustomerFactory.class); 

// get a customer domain object from the factory using a find method 
Customer customer = cf.findByld(id); 

//alternatively, perform functions with customer 

// while still in the session, convert the persistent customer to 
// transient 

Customer transientCustomer = customer.transientCopyO; 

// end the database session 
dbWrapper.endSession(); 
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// return the transient customer 
return transientCustomer; 



} 
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